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Notational Conventions 


THIS TYPE 


italics 


(] 
{ ].. 


(J 


Use these keywords, letters, symbols, 
and punctuation verbatim. Upper or 
lowercase is acceptable. 


Substitute language elements or 
constructs for true terms. 


Optional constructs. 


Optional constructs that can be repeated 
any number of times. 


The preceding item may be repeated, 
but each repetition must be separated 
by a comma. 


Alternate constructs. Choose any one 
of the constructs enclosed in the 
braces. 


/*text enclosed*/ Text enclosed is a prose definition of the 


construct. 


When two adjacent items must be concatenated, they 
appear with no space between them. A blank space 
between two items indicates that the two items may be 
separated by one or more blanks. 


Definitions of Common Terms 


Names can be from 1 to 40 characters long 
and must be composed of letters (A-Z), 
digits (0-9), or special characters (?, @, -). 
The first character must be a letter or a 
special character. 


name 


module-name Same as name. 


segment-name Same as name. 


pathname A valid filename reference or device refer- 
ence. See next two items for examples. 
filename A reference to a disk file. The format is: 
root [.ext ] 
device A reference to a non-disk device. 
Examples: :LP:, .CO:, :TO:. 
value A 16-bit unsigned integer 


Examples: 1011B, 304Q, 4096D (or just 
4096), OC300H 


Same as value. 


address 


RL51 Command Format Summary 


[directory | device] RLS1 input-list [10 output-file] [control-list] 
where 


[directory | device] 
is the directory or device where RL51 resides. 


input-list : = 
input-file [module-list][,...] 


input-file : = 
filename 


RLS1 Command Format Summary (Cont’d.) 


module-list : = 
(module-name [,...]) 


output-file : = 
filename 


control-list ; = 
control ... 


control : = 
listing-control 
linking-control 
locating-control 
configuration-control 
overlay-control 


listing-control_ : « 
print 
pagewidth 
map 
symbols 
publics 
lines 
ixref 


print :* 
PRINT [Cpathname)] 
NOPRINT 


pagewidth : = 
PAGEWIDTH (value) 


map :* 
MAP 
NOMAP 

symbols := 


SYMBOLS 
NOSYMBOLS 


RL51 Command Format Summary (Cont’d.): 


publics :* 


eeeeera 
NOPUBLICS 


lines :* 
LINES | 
NOLINES 
ixref :* 


1 XR E F[Selection-list| 
NOITXREF 


selection-list : = 
( selection-item |....|) 


selection-item : = 


generated 
libraries 


generated := 


eae 
NOGENERATED 


libraries :* 


een | 
NOLIBRARIES 


linking-control : = 
NAME (module-name) 
debugsymbols 
debualines 
debuapublics 


debugsymbols : = 
DEBUGSYMBOLS 
NODEBUGSYMBOLS 


RL51 Command Format Summary (Cont’d.) 


debuglines : = 


DEBUGLINES 
NODEBUGLINES 


debugpublics : = 


DEBUGPUBLICS 
NODEBUGPUBLICS 


locating-control: = 


PRECEDE 

DATA 

BIT 

IDATA (segment |....]) 
STACK 

XDATA 

CODE 


segment :> 
segment-name_ |(address)| 


configuration-control : = 
ramsize 


ramsize :* 
RAMSIZE (value) 


overlay-control : = 


OVERLAY|( overlay-unit [....])| 
NOOVERLAY 


Overlay-unit : * 
Ov-module-name calls ov-module-name 


Ov-module-name : = 


. 


{ module-name \ 


calls :* 
> or] 


Listing Controls 


PRINT [(pathname)] 
NOPRINT 
PAGEWIDTH (value) 


MAP 
NOMAP 
SYMBOLS 
NOSYMBOLS 
PUBLICS 
NOPUBLICS 
LINES 


NOLINES 
IXREF [(selection-list)) 


NOIXREF 


Sends the listing file to the file or device 
specified by pathname. 


Suppresses the listing file; overrides any 
of the following listing controls. 


Specifies the maximum page width to be 
used. 


Outputs memory map to link summary. 


Suppresses memory map. 

Outputs local symbols to symbol! table. 
Suppresses local symbols. 

Outputs public symbols to symbol table. 
Suppresses public symbols. 


Outputs line numbers to symbol table 
(high-level language translators only). 


Suppresses line numbers. 


Appends intermodule cross-reference 
report to print file. 


Suppresses the intermodule cross- 
reference report. 


NOTE: The default for any control (except IXREF) is the positive form 
(PRINT, MAP, SYMBOLS, PUBLICS, and LINES). 


Linking Controls 


Control Effect 

NAME (module-name) Specifies the name of the output 
module. If the NAME control is omitted, 
the output module name defaults to the 
name of the first input module 
processed 

OEBUGSYMBOLS Copies local symbol information to 
Output file X 

NODEBUGSYMBOLS Suppresses local symbols 

DEBUGPUBLICS Copies public symbol information to 
Output file 

NODEBUGPUBLICS Suppresses public symbols 

DEBUGLINES Copies line number information (high- 
level language translators only) to output 
file 

NODEBUGLINES Suppresses line numbers 


NOTE: For all linking controls except NAME. the default is the positive 
form (DEBUGSYMBOLS. DEBUGPUBLICS, and DEBUGLINES). 


Locating Controls 


Control Address Space 
PRECEDE Register banks and bit 
addressable space in 


on-chip data RAM 


Address 
Range 
(Hex) 


Segment Types 
(and Attributes) 


Q0H-2FH 


DATA (UNIT-aligned); 
IDATA 


QOH-7FH 
(see note 1) 


BIT Bit-addressatle space BIT. DATA. IDATA 


in on-chip data RAM 


DATA Directly-addressabie 00H-7FH 


, on-chip data RAM 


DATA (UNIT-aligned): 
IDATA 


OOH-OFFH IDATA 


{see note 2) 


IDATA Indirectly-addressable 
on-chip data RAM 


Same as Same as IDATA 


IDATA 


STACK Same as IDATA (see 
note 3) 


XDATA 
CODE 


O-OFFFFH 
0-OFFFFH 


XDATA External data RAM 
CODE 


Code memory 
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